/* @(#) somx/readme 2.4 1/20/94 10:26:30 [5/15/94 17:59:12] */

/*
 * 96F8647, 96F8648, 96F8850 (C) Copyright IBM Corp. 1992, 1994
 * All Rights Reserved
 * Licensed Materials - Property of IBM
 *
 * DISCLAIMER OF WARRANTIES.
 * The following [enclosed] code is sample code created by IBM
 * Corporation. This sample code is not part of any standard or IBM
 * product and is provided to you solely for the purpose of assisting
 * you in the development of your applications.  The code is provided
 * "AS IS". IBM MAKES NO WARRANTIES, EXPRESS OR IMPLIED, INCLUDING BUT
 * NOT LIMITED TO THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
 * FOR A PARTICULAR PURPOSE, REGARDING THE FUNCTION OR PERFORMANCE OF
 * THIS CODE.  IBM shall not be liable for any damages arising out of
 * your use of the sample code, even if they have been advised of the
 * possibility of such damages.
 *
 * DISTRIBUTION.
 * This sample code can be freely distributed, copied, altered, and
 * incorporated into other software, provided that it bears the above
 * Copyright notice and DISCLAIMER intact.
 */

The "phone directory" sample programs from the SOM documentation on the
Persistence Framework are installed in this directory.  The features
demonstrated by each are summarized below.

These sample programs are equivalent to the C versions with the exception
that main programs have been converted to use the C++ SOM bindings.

To build these sample programs, make sure that the SOM environment variables
have been set up in config.sys by the installation program or by running
the somenv.cmd program. Then, in this directory, run:

   wmake /f makefile.wmk all

To clean up the samples, run:

   wmake /f makefile.wmk clean


There are five sample programs.  While similar, each demonstrates different
features of the Persistence Framework. The executables are:

 sample1p.exe - system-assigned persistent id.
              - all objects in single io/group.
              - uses supplied default attribute encoder/decoder.

 sample2p.exe - system-assigned persistent id.
              - each objects in a separate io/group.
              - uses supplied default attribute encoder/decoder.

 sample3p.exe - client-assigned persistent id.
              - all objects in a single io/group.
              - uses supplied default attribute encoder/decoder.

 sample4p.exe - client-assigned persistent id.
              - all objects in a single io/group.
              - client-supplied encoder/decoder.

 sample5p.exe - object modification.
              - system-assigned persistent id.
              - all objects in a single io/group.
              - uses supplied default attribute encoder/decoder.
